home *** CD-ROM | disk | FTP | other *** search
/ CD World Haziran 1997 / CD World Haziran 1997.iso / Internet ve Net Programlari / WebSite WEB Server Evaluation / WebSite WEB Server evaluation version. 32 bit Windows required.Z / TROUBL~1.HT_ / TROUBL~1.HT
Encoding:
Text File  |  1995-05-09  |  8.7 KB  |  199 lines
  1. <TITLE>WebSite 1.0 Troubleshooting Tips</TITLE>
  2. <h1><IMG SRC="images/website.gif" alt="WebSite 1.0a" WIDTH=216 HEIGHT=72>
  3. Troubleshooting Tips</H1>
  4. <p>
  5. Rather than try to cover the variety of problems you
  6. might
  7. encounter using WebSite in your particular environment, this document provides
  8. some general guidelines of where to look for information on diagnosing and
  9. solving those problems yourself.
  10. <p>
  11. Because some problems are common (or extremely specific), we include them as
  12. well. And sometimes you just have to start over and reinstall the software.
  13. This
  14. document includes the procedure for
  15. <a href=#install>reinstalling and uninstalling the WebSite
  16. software</a>.
  17. <p>
  18. If you work through these items and still cannot solve the problem, check the
  19. online resources at
  20. <a href=http://website.ora.com>WebSite Central</a>.
  21. O'Reilly & Associates does not provide technical support for demonstration versions.
  22. <p>
  23. Many of the problems you may encounter when installing and starting
  24. your server are networking related. The specific problems can be myriad,
  25. from a mistyped IP address to a wrongly-configured TCP/IP setup. These
  26. problems are beyond the scope of this book and should be addressed to
  27. your network administrator or your Internet service provider. If you
  28. suspect the problem is with your TCP/IP configuration, see the
  29. documentation for your operating and network systems.
  30.  
  31. <h2>Try Looking in These Places</h2>
  32. <p>
  33. The following troubleshooting guidelines will help you diagnose and solve
  34. problems you may encounter.
  35. <ul>
  36. <li> Run the <a href=http://localhost/wsdocs/32demo/>WebSite server self-test</a> to
  37. verify that your server is set up correctly.
  38. <li> Test your network connection with another tool or application such as
  39. ping or telnet.
  40. <li> Stop the server and check the error log (look in the <tt>logs</tt>
  41. subdirectory of your WebSite installation directory).
  42. <li> Stop the server and check the server log. Note that restarting the
  43. server
  44. wipes out the contents of this log.
  45. <li> Enable various tracing options for the server log, and recreate the
  46. problems
  47. you are having. Then stop the server and check the tracing data in the server
  48. log. Remember that restarting the server wipes out this log.
  49. <li> Check the WebSite abort log (located in the WebSite directory) for
  50. fatal
  51. internal server errors.
  52. <li> Check the Application Event Log (from the Windows NT Event Viewer) for
  53. information and warnings about problems with the application.
  54. <li> Check the diagnostics information provided for HTML files in WebView
  55. for
  56. possible HTML tagging errors..
  57. <li> Look closely at the error messages sent from the server to the browser.
  58. For
  59. example, in the "Not Found" return, the server reports both the URL and the
  60. physical file pathname for the URL target-information invaluable in diag-
  61. nosing mapping problems. Not all browsers save error messages. If yours
  62. doesn't, we recommend you try another browser or enable Dump Sent Data
  63. tracing, which shows what the server sent to the browser.
  64.  
  65. <li> Your Web browser's View Source option often points out useful
  66. information --
  67. perhaps an HTML tag is missing or incomplete.
  68. <li> If you are doing CGI work, enable CGI tracing in Logging and use the
  69. <tt>DEBUG_MODE</tt> CGI variable to enable debugging/tracing features of your
  70. CGI program.
  71. </ul>
  72.  
  73. <h2>Some Specific Situations</h2>
  74. <p>
  75. The items listed below are specific situations you may encounter:
  76. <ul>
  77. <li> If you installed WebSite on a drive other than <tt>C:</tt>, you may need to
  78. create a
  79. <tt>C:\TEMP</tt> directory. WebSite uses this directory for writing output files,
  80. particularly
  81. when you have CGI tracing enabled. WebSite will not start properly
  82. without a <tt>C:\TEMP</tt> directory.
  83. <li> If you want to run WebSite as a service, make sure you change the run
  84. mode
  85. on the General page of Server Admin.
  86. <li> If you change the file permissions on WebSite files, the server may not
  87. run or
  88. may not run properly.
  89. <li> You may have insufficient DOS environment space (Windows 95 only). The
  90. self-test requires the server to run CGI programs in a DOS window. The
  91. programs will fail if you don't have enough environment space. Add the line
  92. CommandEnvSize=8192 to the [NonWindowsApp] section of system.ini
  93. </ul>
  94.  
  95. <h2>Look for Answers at WebSite Central</h2>
  96. <p>
  97. If you can't solve your problem with the resources above, the online resources
  98. are the next place to look. <a href=http://website.ora.com/>WebSite Central</a>,
  99. a WebSite maintained for WebSite
  100. users by the technical support staff of O'Reilly & Associates, provides product
  101. information, answers to frequently asked questions (FAQs), troubleshooting
  102. help,
  103. advice for particular implementations of WebSite, ideas for new uses of
  104. WebSite,
  105. sample HTML files, helpful utility programs, and opportunities to interact with
  106. the
  107. technical support staff and other WebSite users.
  108. <p>
  109. You can tap the resources at WebSite Central with your browser and find how
  110. others have dealt with similar problems. In addition, the Frequently Asked
  111. Questions
  112. (FAQs) published on WebSite Central may provide just the answer you
  113. need. You will also find pointers to other resources on the Web, such as
  114. specifications and external viewers.
  115.  
  116. <a name=install>
  117. <h2>Start All Over Again</h2>
  118. </a>
  119. <p>
  120. Sometimes, the only way to fix a problem is to start over with fresh copies of
  121. the
  122. software. The WebSite Setup utility includes options to let you reinstall or
  123. uninstall
  124. the WebSite software.
  125.  
  126. <h3>Reinstalling WebSite</h3>
  127. <p>
  128. Reinstalling the software does not affect any of your web documents or most of
  129. your WebSite configuration (for example, mapping, image maps, access control).
  130. When you reinstall WebSite, you can change the physical location of the server,
  131. the
  132. server's fully qualified domain name, the email address of the server
  133. administrator,
  134. and the default document root and index file name. Note that you can make these
  135. same changes through Server Admin. Reinstall is also
  136. used
  137. for installing software updates to WebSite.
  138. <p>
  139. To reinstall WebSite, make sure the server and browser are not running and
  140. follow these steps:
  141. <ol>
  142. <li> Insert the medium containing the WebSite demo in your
  143. computer and execute the Setup program by double-clicking on the setup.exe
  144. file in the File Manager. The WebSite Setup utility window appears.
  145. <li> Press Install. The reinstallation procedure is the same as when
  146. you first
  147. installed WebSite. You will be asked a series of questions about your server
  148. and web.
  149. </ol>
  150.  
  151. <h3>Uninstalling WebSite</h3>
  152. <p>
  153. Uninstall, on the other hand, lets you remove all or part of your existing
  154. WebSite
  155. server and web and start over completely. Using Uninstall, you can remove the
  156. WebSite service (Windows NT only), delete the WebSite registry keys, and/or
  157. delete the entire WebSite directory. Uninstall is a drastic measure; please
  158. read the
  159. warning and follow the steps below when running Uninstall.
  160. <p>
  161. Using the Uninstall option of the WebSite Setup utility completely
  162. removes all or part of your existing WebSite (service, registry keys, and
  163. documents included in the WebSite directory). Back up any documents and
  164. note any registry configurations (mapping, access control, image maps)
  165. you wish to retain. Read the following instructions carefully.
  166. <p>
  167. To Uninstall WebSite, follow these steps:
  168. <ol>
  169. <li> Insert the medium containing the WebSite demo in your
  170. computer and execute the Setup program by double-clicking on the setup.exe
  171. file in the File Manager. The WebSite Setup utility window appears. 
  172. <li> Press Uninstall. The program asks you three questions about 
  173. which part(s) of WebSite to remove:
  174. <ul>
  175. <li> Remove WebSite Service?  If you answer yes, the program removes the
  176. service components of WebSite. You will no longer be able to run
  177. WebSite as a service (Windows NT only).
  178. <li> Delete WebSite Registry Keys? If you answer yes, the program completely
  179. removes all configuration values for WebSite, including mapping, image
  180. maps, access control, automatic directory indexing setup, users, groups,
  181. and realms. Make sure you want to delete this information before
  182. responding yes. If your problems with WebSite are unsolvable any other
  183. way, you will have to answer yes.
  184. <li> Delete <tt>C:\WEBSITE</tt>? If you answer yes, the entire WebSite directory
  185. structure is completely deleted, including any web documents you have created
  186. in the default document mapping space (that is, <tt>HTDOCS</tt>) or in any
  187. other location under the WebSite directory. To retain these documents,
  188. make sure they are backed up before responding yes. Note that this ques-
  189. tion will show your actual WebSite working directory, which may or may
  190. not be <tt>C:\WEBSITE</tt>.
  191. </ul>
  192. <li> Respond yes or no to each question as appropriate for the
  193. action you wish to
  194. accomplish.
  195. <li> Install WebSite again.
  196. </ol>
  197.  
  198.  
  199.